Skip to content

Update from code changes: sourceRef nested GitLab subgroup paths - #7273

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/02309cab
Open

Update from code changes: sourceRef nested GitLab subgroup paths#7273
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/02309cab

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Summary

sourceRef values in multi-repository deployments now accept GitLab repository paths with two or more segments, so repos in nested subgroups can be referenced by their full group path or by a short subgroup/repo alias. Previously, resolution required exactly two segments and nested-subgroup repos could not be referenced at all. Short aliases are dropped when two sources share the same trailing segments, in which case the full path is required. Single-segment values still fail validation.

https://github.com/mintlify/server/pull/7952

Changes

  • Updated sourceRef requirements on deploy/multi-repo.mdx: values need at least two path segments, full nested paths are supported, and short trailing aliases work unless ambiguous.
  • Added a nested-subgroup sourceRef example to the usage section.
  • Mirrored the changes in the Spanish, French, and Chinese translations.

Note

Low Risk
Documentation-only changes to multi-repo sourceRef guidance with no runtime or config code touched.

Overview
Updates multi-repository sourceRef docs to match new resolution rules (see mintlify/server#7952): values need at least two path segments (not strictly owner/repo), and GitLab repos in nested subgroups can use a full path such as acme/platform/api-docs or a two-segment alias when it is unambiguous.

The Requirements and Usage sections in deploy/multi-repo.mdx gain GitLab-specific guidance and a nested-subgroup JSON example; the same edits are mirrored in the Spanish, French, and Chinese pages.

Reviewed by Cursor Bugbot for commit 039679b. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 5, 2026, 8:18 AM

@mintlify

mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
tomee 🟡 Building Sep 5, 2026, 8:17 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants